home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / sapphire.zip / SAPPHTS.DOC < prev    next >
Text File  |  1992-01-10  |  16KB  |  293 lines
  1. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  2. █ HOW TO USE THIS TROUBLE-SHOOTING GUIDE                                       █
  3. █──────────────────────────────────────────────────────────────────────────────█
  4. █                                                                              █
  5. █ This guide is contained in the file  SAPPHTS.DOC.  You can print it out, but █
  6. █ it works best if you view it via the SYSOP menu, which uses our SEE program. █
  7. █ To do that, enter SYSOP at the DOS prompt, select INFO, then select TROUBLE. █
  8. █ This lets you search the guide for keywords whenever you have a problem.     █
  9. █                                                                              █
  10. █ Each problem described in this file is  preceded by a list of keywords, each █
  11. █ of which is preceded by  a slash character  (/).   Thus,  if you had a modem █
  12. █ problem, you could press "F" (for Find) then search for  /MODEM.  By repeat- █
  13. █ edly searching  for  /MODEM  (press  F3  after  the initial search)  you can █
  14. █ quickly scan the file for any related problems.                              █
  15. █                                                                              █
  16. █ When in doubt about  which keyword to choose,  use the shortest one that can █
  17. █ describe your problem.  For example,  if a user has trouble connecting, look █
  18. █ for /CONNECT rather than /CONNECTION PROBLEM,  since /CONNECT would match on █
  19. █ /CONNECT or /CONNECTING or /CONNECTION and so on.  Most important, avoid any █
  20. █ plurals:  search for /MODEM, not /MODEMS.                                    █
  21. █                                                                              █
  22. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  23.  
  24.  
  25. ───────────────────────────────────────────────────────────────────────────────
  26. KEYWORD:  /MODEM/ANSWER/CALL
  27. PROBLEM:  Modem doesn't answer incoming calls.
  28.  
  29. This happens if the modem is not configured correctly, either in hardware or
  30. modem settings.  Check all of the following suggestions; one of them may solve
  31. your problem.
  32.  
  33. ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  34. HARDWARE PROBLEMS
  35. ···············································································
  36.  
  37. 1.  If, when you start up Sapphire, it does NOT have an error-free dialog
  38.     with the modem (i.e. if it complain about a carrier, or modem not
  39.     ready, or if the modem never responds "OK"), refer to the trouble-
  40.     shooting section concerned with those problems (do a keyword search for
  41.     (slash)CARRIER, (slash)NOT READY or (slash)OK).
  42.  
  43. 2.  If you have an external modem (a box outside your computer, as opposed
  44.     to a card inside your computer), check the following:
  45.  
  46.     A.  Is your modem plugged in?  (Are lights glowing on the front panel?)
  47.  
  48.     B.  Is the modem plugged into the phone line?
  49.  
  50.     C.  Is the phone line plugged into the CORRECT plug on the modem?
  51.         (Some modems have one plug for the line and one for a handset)
  52.  
  53. 3.  As an aid to understanding the problem, try calling the modem on a voice
  54.     phone.  Does it pick up the line?  If it does pick up the line, do you
  55.     hear a carrier?
  56.  
  57. ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  58. MODEM SETTINGS
  59. ···············································································
  60.  
  61. 1.  If you have an external modem, it may have some lights which indicate how
  62.     it is set, or what signals it is receiving.  Check these lights and
  63.     settings, and compare them with the informatin in your modem manual.
  64.  
  65.     LIGHT                  USUALLY AFFECTED
  66.     LABEL  MEANING         BY MODEM COMMAND  RELATED ITEMS IN THIS GUIDE
  67.     ─────  ──────────────  ────────────────  ───────────────────────────
  68.     AA     Auto-Answer     ATS0=1            Search for (slash)DIP
  69.     MR     Modem Ready     AT&D1             Search for (slash)DIP
  70.     TR     Terminal Ready  N/A
  71.     OH     Off-hook        ATH0              Should be OFF, not on.
  72.  
  73.     LIGHT
  74.     LABEL  MEANING         COMMENTS
  75.     ─────  ──────────────  ────────────────────────────────────────────────
  76.     SD     Send            Should flash when modem  receives  your commands
  77.     RD     Read            Should flash when modem replies to your commands
  78.  
  79. 2.  If you have an internal modem, you still have to make the settings
  80.     correctly, but you won't see any lights to indicate if your commands
  81.     have been accepted.
  82.  
  83. ───────────────────────────────────────────────────────────────────────────────
  84. KEYWORD:  /MODEM/ANSWER/SPEED
  85. PROBLEM:  Modem answers incoming calls okay at some speeds but not at others.
  86.  
  87. 1.  In configuring your modem, you must take care to set the X setting
  88.     properly.  For example, some settings may not show the baud rate
  89.     properly.  In general, use the highest X setting supported by your modem.
  90.  
  91. 2.  If you are having trouble at baud rates of 9600 or more, you will have to
  92.     consult your modem manual.  A sample problem:  the other person might be
  93.     trying to connect an HST at 9600 to a V32 modem at 9600 -- but the two
  94.     methods are not compatible.
  95.  
  96. ───────────────────────────────────────────────────────────────────────────────
  97. KEYWORD:  /MODEM/HANG UP/ECHO
  98. PROBLEM:  When user hangs up, modem endlessly echoes back to Sapphire.
  99.  
  100. Some modems don't have time to drop the carrier while characters are being
  101. sent.  For this reason, you have to configure the modem not to echo command
  102. characters.  This can cause an echoing loop when somebody hangs up.
  103.  
  104. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  105. | The solution given here applies to most modems, but check your modem manual |
  106. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  107. ┌·─·─·─·─·─·─·─·┬·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  108. |   MODEM HAS   |                                                             |
  109. | DIP SWITCHES? | ACTION TO BE TAKEN                                          |
  110. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  111. |     YES       | Set switch 4 to NOT echo characters                         |
  112. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  113. |     NO        | Include E0 - not E1 - in your modem initialization command  |
  114. └·─·─·─·─·─·─·─·┴·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  115.  
  116. ───────────────────────────────────────────────────────────────────────────────
  117. KEYWORD:  /MODEM/CARRIER
  118. PROBLEM:  Sapphire says that the modem is presenting a carrier.
  119.  
  120. You must set your modem so that it does NOT present a carrier -- unless some-
  121. body has dialed in and is connected.
  122.  
  123. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  124. | The solution given here applies to most modems, but check your modem manual |
  125. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  126. ┌·─·─·─·─·─·─·─·┬·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  127. |   MODEM HAS   |                                                             |
  128. | DIP SWITCHES? | ACTION TO BE TAKEN                                          |
  129. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  130. |     YES       | Set switch 6 to use CD line                                 |
  131. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  132. |     NO        | Try including &C1 in your modem initialization command      |
  133. └·─·─·─·─·─·─·─·┴·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  134.  
  135. ───────────────────────────────────────────────────────────────────────────────
  136. KEYWORD:  /MODEM/NOT READY
  137. PROBLEM:  Sapphire says that the modem is not ready.
  138.  
  139. 1.  If you have an external modem, are all wires of the modem cable connected
  140.     properly?
  141.  
  142.     A.  If you have a "null modem cable" (pins 2 and 3 cross-connected)
  143.         Sapphire won't answer.
  144.  
  145.     B.  Use some wire, a flashlight battery, and a flashlight bulb as a simple
  146.         continuity tester, check that the important pins are connected end-to-
  147.         end:
  148.  
  149.         Pin 1 (or Pin 7)   Pin 2   Pin 3   Pin 8   Pin 20
  150.  
  151.         The pin numbers are usually written in tiny letters on one of the
  152.         connectors, or pin 1 is marked with a little arrow.
  153.  
  154. 2.  Make sure that the modem is configured to use the Terminal Ready line.
  155.  
  156. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  157. | The solution given here applies to most modems, but check your modem manual |
  158. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  159. ┌·─·─·─·─·─·─·─·┬·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  160. |   MODEM HAS   |                                                             |
  161. | DIP SWITCHES? | ACTION TO BE TAKEN                                          |
  162. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  163. |     YES       | Set switch 1 to use DTR line                                |
  164. ├·─·─·─·─·─·─·─·┼·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┤
  165. |     NO        | Try including &D1 or &D2 in modem initialization command    |
  166. └·─·─·─·─·─·─·─·┴·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  167.  
  168. ───────────────────────────────────────────────────────────────────────────────
  169. KEYWORD:  /MODEM/OK/AT COMMANDS
  170. PROBLEM:  The modem never responds "OK" to the commands I send it.
  171.  
  172. Try configuring the modem at a lower baud-rate -- it may be missing some of the
  173. responses.  We recommend that you always initialize at 300 baud.  The initial-
  174. ization baud-rate is set via the SYSOP program.
  175.  
  176. ───────────────────────────────────────────────────────────────────────────────
  177. KEYWORD:  /MODEM/DIP SWITCHES
  178. PROBLEM:  Modem has DIP switches.
  179.  
  180. Older modems have tiny DIP (dual-inline-package) switches (sometimes you have
  181. to open the modem to find the bank of switches).  In most cases, they are set
  182. as follows:
  183.  
  184. ┌·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┐
  185. | The solution given here applies to most modems, but check your modem manual |
  186. └·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·─·┘
  187.  
  188.       Switch 1 UP:   Computer should use the Data Terminal Ready (DTR) line
  189.       Switch 2 UP:   Result codes sent as words
  190.       Switch 3 DOWN: Result codes are sent to the computer
  191.       Switch 4 UP:   Echo incoming characters
  192.       Switch 5 DOWN: Don't answer incoming calls
  193.       Switch 6 UP:   Computer should use the Carrier Detect (CD) line
  194.  
  195. These modems may also have switches 7 and 8; check your manual to see how
  196. they should be set.
  197.  
  198. ───────────────────────────────────────────────────────────────────────────────
  199. KEYWORD:  /RANDOM/CHARACTERS/NOISE/GARBAGE/CONNECTING
  200. PROBLEM:  Users see some random characters when they connect.
  201.  
  202. 1.  If only one user has this problem, ask him to try on a different modem,
  203.     or to try from another location.
  204.  
  205. 2.  If everybody has this problem, disconnect ALL phones at your house (even
  206.     those on other lines) except the modem.  If this cures the problem, it
  207.     may indicate the problem.  Some conference phones, for example, cause
  208.     leakage between lines, which causes line noise.
  209.  
  210. ───────────────────────────────────────────────────────────────────────────────
  211. KEYWORD:  /RANDOM/CHARACTERS/NOISE/GARBAGE/CONNECTING
  212. PROBLEM:  Users see nothing but random characters when they connect.
  213.  
  214. 1.  If you have this problem during early testing, make sure that the other
  215.     person has called other BBS's before, at the baud rate being attempted,
  216.     and that the baud rate being attempted is within the capabilities of both
  217.     modems.
  218.  
  219. 2.  See also the previous trouble-shooting item (occasional noise).
  220.  
  221. ───────────────────────────────────────────────────────────────────────────────
  222. KEYWORD:  /COMMANDS/SET/NAMES/TEXT
  223. PROBLEM:  I don't understand how SET, NAMES or TEXT work.
  224.  
  225. These commands "tune" other commands to restrict or control what they report.
  226. SET controls them by time, NAMES by the name of the person or file being
  227. referenced, and TEXT by any text (apart from name-oriented text) that might
  228. be presented by the command.
  229.  
  230. ───────────────────────────────────────────────────────────────────────────────
  231. KEYWORD:  /USER/ENTER/INPUT/FREEZE
  232. PROBLEM:  User has to press Enter twice after each input.
  233.  
  234. The symptom is that the user will type some input, hit Enter, and the cursor
  235. will "freeze" in column one -- before doing a linefeed -- and will not move
  236. on until he hits another character.
  237.  
  238. This happens when the user sets his terminal program to send a CTRL-S whenever
  239. he presses Enter.  For some reason, some Macintosh terminal programs seem to
  240. come pre-configured this way.
  241.  
  242. Over the phone, it is very difficult to explain to a user how to solve this
  243. problem.  In brief, however, he should look through his terminal program's
  244. configuration section for something labelled "handshaking" or "ASCII protocol",
  245. or something like that, and disable handshaking there.
  246.  
  247. ───────────────────────────────────────────────────────────────────────────────
  248. KEYWORD:  /USER/INPUT/CHARACTERS/MISSING
  249. PROBLEM:  Some of the characters the user types are lost.
  250.  
  251. Sapphire can have problems with multi-tasking software such as DesqView.  The
  252. Sapphire serial routines are poll-driven rather than interrupt-driven.  What
  253. this means is that, if you're running multi-tasking software, your users may
  254. lose characters when they type.
  255.  
  256. Poll-driven I/O offers total port compatibility with all hardware platforms
  257. upon which Sapphire is likely to be run, but it does make it inappropriate for
  258. multi-tasking machines.
  259.  
  260. ───────────────────────────────────────────────────────────────────────────────
  261. KEYWORD:  /FILE LIST/FULL/DISK/SPACE
  262. PROBLEM:  File list is full
  263.  
  264. In most cases, the file list is self-maintaining, but if ALL of the files have
  265. been on the list for less than 14 days, auto-maintenance is disabled.
  266.  
  267. When this happens, you can manually delete some files, using the FILES command
  268. (when logged in at user level 8), or you can wait for a few days for some files
  269. to time out.
  270.  
  271. ───────────────────────────────────────────────────────────────────────────────
  272. KEYWORD:  /PROGRAM/FAILURE/ERROR CODE/RUNTIME ERROR/IO ERROR/BUG
  273. PROBLEM:  Program fails with an error code.
  274.  
  275. Call our BBS at 514-345-8654 and have a look around.  We may have a copy of
  276. SAPPHTS.DOC that covers your problem or a new version of SRUN.EXE that solves
  277. it.  If that doesn't help, call our voice support line at 514-345-9578.  You
  278. can call 24 hours per day; our answering service will take a message if we
  279. do not have technical staff on-site to take your call.
  280.  
  281. If you think you've spotted a bug in Sapphire, the most important thing you
  282. can do to help us is make it happen on demand.  That is to say, before you
  283. report a problem, try to understand it well enough to make it happen on
  284. purpose.  Here's a checklist to help you assess the problem:
  285.  
  286.   1.   What do you think causes the problem?
  287.   2.   How often does it happen?
  288.   3.   Does it happen to everybody or just certain people?
  289.   4.   Did it start just recently or has it always happened?
  290.   5.   If it just started, what changed just before it started?
  291.   6.   What have you done to try to solve the problem?
  292.  
  293.